Skip to main content

Windows Setup

Use this page only for Windows-specific setup. The app creation flow is covered in Getting Started.

Install the required Node version​

The current @corva/create-app release requires Node.js 24.15.0. You can install it directly or use NVM for Windows when you maintain projects on multiple Node versions.

With NVM for Windows:

nvm install 24.15.0
nvm use 24.15.0
node --version

Close and reopen the terminal after installation if node is not found.

Choose npm or Yarn​

The scaffolder supports both package managers. npm is included with Node, so a global Yarn installation is not required.

For npm:

npm start

For a project generated with Yarn:

yarn start

Use the package manager selected during scaffolding and commit its lockfile.

Configure the hostname​

Open Notepad as an administrator and add this entry to C:\Windows\System32\drivers\etc\hosts:

127.0.0.1 app.local.corva.ai

The local app URL is http://app.local.corva.ai:8080.

Common problems​

Runtime "ui" is not available locally​

Run node --version. Switch to exactly 24.15.0, reopen the terminal, and rerun the current scaffolding command.

node.exe is not found after nvm use​

  • Remove or disable an older standalone Node installation.
  • Restart the terminal.
  • Run nvm list and confirm 24.15.0 is installed.
  • Rerun the NVM installer if its PATH entries are missing.

PowerShell blocks a package-manager script​

If your organization permits user-scoped script execution, run:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Otherwise, use Command Prompt or follow your organization's PowerShell policy.

The browser opens the wrong address​

Open http://app.local.corva.ai:8080 manually. Older documentation and projects may still mention HTTPS or port 5000; those are not the current scaffold defaults.